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I. INTRODUCTION 


In our proposal which led to this grant entitled “Analysis and Interpretation 
of Diffuse X-ray Emission Using Data from the Einstein Satellite,” we outlined 
an ambitious program to create a uniquely powerful and accessible archive of the 
HEAO-2 Imaging Proportional Counter (IPC) database and to begin exploring the 
scientific utility of that database for studies of diffuse X-ray emission. We have 
largely achieved our goals. 

II. TECHNICAL ACCOMPLISHMENTS 

As of June 1990, we had available on three large-format optical disks all in- 
formation for the more than 200,000,000 photons detected by the IPC during its 
operational lifetime. This represents all of the data recorded in all 4079 HEAO- 
2 sequence ntimbers. By all photons we mean: all energy channels, masked out 
counts as well as those included in standard C0 / x 60* images, all viewing geometry 
codes, all background levels, aspected (for all aspect solution quality levels) as well 
as non-aspected data, calibration sequences - everything. The data are grouped by 
HUT.XPR files and include the .TGR and ASP. MAG files - essentially everything that 
is needed to construct images and perform spatial, spectral, and timing analysis. 
An exhaustive catalog provides for easy browsing; for example, determining the 
number of 1.5 - 3.5 keV photons available for timing analysis (including no- aspect 
data at viewing geometries 1 — 3 for all background levels) for 3C273 requires only 
the position of 3C273 and 30 seconds of the user’s time. Incidentally, these looser 
photon acceptance criteria, appropriate for timing and spectral analysis of most 
point sources, will provide 30 — 40% more data than was available heretofore. 

Physically mounting the desired disk takes 1 minute, while transferring all of 
the relevant files to magnetic disk is completed in less than 30 seconds. A software 
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system to construct and analyze images including a variety of innovations such as 
flexible data editing, solar-scattered flux and cosmic ray contamination removal, 
flat-fielding, optimized source detection algorithms for point and extended sources, 
etc. has also been completed and documented. A user’s reference manual for the 
system - Op-Ed (for Optical disk Processing of Einstein Data) - has also been 
written; a copy is attached as Appendix A. The system has been used by several 
Columbia faculty and students not associated with the project, as well as by visitors 
from Princeton, Caltech, and elsewhere. Remote use of the system has also been 
demonstrated; as an example, the entire database was downloaded over commercial 
networks using FTP to the University of Washington where it is now in use. We are 
currently engaged in discussions with the High Energy Astrophysics Science Archive 
Research Center (HEASARC) at the GSFC to transfer the database and software 
system to them to ensure continued community access followingthe termination of 
our funding. We expect this transfer to be completed shortly. 

III. SCIENTIFIC ACCOMPLISHMENTS 

The significant scientific benefits of the new IPC database and analysis system 
have been summarized for the community in three papers, all of which are now 
scheduled for publication in The Astrophysical Journal during 1991: 

1. “The Detection of X-rays from the Hot Interstellar Medium of the Large Mag- 
ellanic Cloud,” by Wang, Hamilton, Helfand and Wu describes data editing, 
solar scattered flux decontamination, spectrally dependent vignetting correc- 
tions necessary for analyzing diffuse emission, and a number of techniques for 
constructing maps from mosaiced images. 

2. “The Intensity and Spectrum of the Diffuse X-ray Background,” by Wu, Hamil- 
ton, Helfand and Wang includes detailed descriptions of flat-field construction 
and application for the IPC, the spectrum and intensity of both cosmic ray 
events and the calibration source leak, and source excision algorithms. 

3. “Faint X-ray Source Counts and the Origin of the X-ray Background,” by 
Hamilton, Helfand, and Wu includes a detailed description of considerations 
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relevant to faint source detection in IPC fields and presents an optimized al- 
gorithm for finding source candidates, selecting detection thresholds, and mea- 
suring source parameters. 

These three papers also present major new scientific findings relevant to the 
global structure of the interstellar medium and the origin of the cosmic X-ray back- 
* ground. Preprints of these accepted papers are available on request. 

In addition, we have constructed an all-sky map of the diffuse X-ray emission 
(all discrete sources subtracted) in each of nine energy bands derived from the 
entire database. An example is reproduced as Figure 1. Since the HEAO-2 IPC 
only covered ~ 5% of the sky with pointed observations, the pixel size is chosen 
as 5° x 5° in this figure, although spatial information on the diffuse emission is 
available on scales down to ~ 5 ' limited only by the statistics of the data. This 
map, as well as the catalog of sources which was an inevitable byproduct of its 
creation, is proving useful in planning future observations (e.g., with ROSAT) as 
well as providing important new scientific information on the Galactic contribution 
to the diffuse X-ray background. 

IV. PERSONNEL 

Over the eighteen-month funding period, this grant has supported, in whole 
or in part, the work of one faculty member (the PI), three post-doctoral fellows, 
two graduate students, two undergraduates and one contracts administrator (sum- 
marized in Table 1). Both graduate students received their Ph.D.s toward the end 
of the grant period; one is now a post-doctoral fellow at the University of Wahs- 
ington working on NASA-sponsored research with Professor Bruce Margon and the 
other is a post-doc at SUNY Stonybrook working with Professor F. Walter on data 
from the HST GHRS. One of the undergraduates has gone on to graduate school 
in Astronomy, while the other will be a student at the National Radio Astronomy 
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Observatory this summer. The post-doc receiving most of his support under this 
grant (T. Hamilton) was awarded a highly competitive NASA Long Term Space 
Astrophysics Research Program 5-year grant (as was the PI). Another of the short- 
term post-docs (L. Kay) now has a faculty position in Astronomy and has received a 
Summer Fellowship at the NASA-Ames Research Center this year. In summary, the 
scientific personnel supported under this grant have all gone on (or are continuing) 
to make significant contributions to the national research program in astrophysics. 


Table 1: Personnel 


NAME 

POSITION 

D. Helfand 

Professor (PI) 

T. Hamilton 

Post-doctoral Research Fellow 

L. Kay 

Post-doctoral Research Fellow 

W. van der Veen 

Post-doctoral Research Fellow 

X. Wu 

Graduate Student 

S. Zoonematkermani 

Graduate Student 

H. Richman 

Undergraduate/Research Aide 

J. Broekman 

Undergraduate 

V. Buckingham 

Administrator 
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Chapter I 


INTRODUCTION TO Op-Ed 


The Optical-disk Processing System for Einstein Data has been 
designed at Columbia University to create efficient and 
convenient access to the IPC data. Op-Ed can be initiated 
by typing 'Op-Ed' after the usual UNIX C shell prompt (%) 
from any directory. 

Op-Ed consists of a user friendly interface system, a manual 
explaining how to use the software and several optical disks 
that contain the IPC files. The interface system is run on the 
CONVEX in the directory /mnt2/Einstein/oped_command. Each user 
works in his/her own subdirectory, thus providing a protected 
working environment. All output files produced by Op-Ed are 
written to the directory /ipc/{user name). A description of 
the structure and procedures of the user interface is provided 
by the Op-Ed manual. 

The manual for Op-Ed is divided into both sections and chapters. 
Where appropriate, examples have been included. In addition, a 
table of contents is provided to assist users in locating 
specific information. 

The optical disk drive is located in Pupin Hall on the 13th 
floor beside the CONVEX. The dis£s containing IPC files are 
in office 1331. For instructions on how properly to use the 
optical disk please refer to chapter II. 5 in this manual. 

Certain notation is used throughtout the manual; note that all 
Op-Ed commands are enclosed in the symbols O. 

Furthermore, several acronyms have been adopted for the sake 
of convenience to both the Op-Ed users and the Op-Ed writers. 

The acronyms listed below appear throughout the manual and in 
the text of the interface: 

IPC - Imaging Proportional Counter 

XPR - X-ray Photon Record 

TGR - Timing Gap Record 

PI - Pulse Independent 

PHA — Pulse Height Amplitude 

HUT - HEAO Universal Time 
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LET'S GET STARTED 


To initiate the Optical-Disk Processing System of Einstein 
Data, the user must log on to the CONVEX into his/her account. 
If a user does not have an account, or accesss to one, on the 
CONVEX at Columbia University, please see Claire Russel in 
Pupin Hall room 1008A. Once the user has successfully logged 
on to the CONVEX, he/she may type Op-Ed after the UNIX pronqpt %• 
The Op-Ed greeting should appear: 

Welcome to the Optical-Disk Processing of Einstein— Data at 
Columbia University! 

Welcome to Op-Ed! 

Op-Ed is designed to perform: 

- Photon and Time Filtering 

- Image Production 

- Source Identification and Analysis 

- Produce Inputs for Spectral Analysis Programs 


Type help for a list of the available commands. 
Op-Ed> 


At this point, the user may type <help> to obtain a list 
of the Op-Ed commands. However, if the user is familiar with 
Op-Ed he/she may proceed directly to a specific command. 

When using Op-Ed, please remember to use only lower case 
letters. Also, when a reply of "yes" or "no" is required, 
the user can not abbreviate. 
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HANDY UNIX COMMANDS 


Op-Ed is designed to permit the user to take advantage of 
the ordinary UNIX commands as supplemental operations. To 
return to the UNIX prompt %/ the user may either <exit> Op-Ed, 
or he/she may type "ctrl-z" . The operation Ctrl— z permits 
the user to suspend the Op-Ed screen temporarily in order to 
use UNIX commands. To return to Op-Ed, the user must type 
H fg" after the UNIX prompt %. 

For users not familiar with UNIX, below is a list of 
convenient functions and explanations, 

% cat (filename) - scrolls the contents of the designated 
file onto your screen. 

% help - is a built in, easy-to-use aid for the UNIX System. 

% info (command) — provides the user with information about 

any UNIX command. Info is an on-line indexing utility 
for UNIX commands. 

% man (command) - is similar to info. Man also provides the 
user with information about any UNIX command. Man 
accesses the reference material in the "CONVEX UNIX 
P r ogramme r ' s Manua 1 " . 

% ps agu - displays information about processes that are being 
run on the computer. The information includes the user 
ID, the status of the process, the CPU time accumulated 
by the process and the process name. 

% cd - changes the directory. The user should indicate which 
directory he/she would like to change to. 

% cp (sourcefile) (destination) - makes an exact replica of a 
file and puts it in another file name. 

% rm (file name) - removes or deletes one or more files from a 
directory. 

% mv (oldname) (newname) - changes the name of a file or directory, 
or moves a file to another directory. 

% mount__od (ipc_#disk) - mounts the optical disk that is currently 
on the drive. Do not use if unfamiliar with this command. 

See % man mount. 

% umount_od (ipc_#disk) - unmounts the optical disk that is currently 
on the drive. 

% print (filename) - submits a file to be printed on the line printer 
with a header. 


STRUCTURE 


The following is a summary of the Op-Ed commands. They are 
usually performed in the order listed below: 


<help> 

<diskcheck> 

<spacecheck> 

<reraove> 

<select> 

<load> 

<scan> 


<exam> 

<araip> 

<exit> 


- provides a list of the available Op-Ed commands. 

- determines which disk is on the drive and if it is active. 

- checks the status of the magnetic disk space. 

- removes all XPR files in the directory ipc/ (user name) . 

- enables the user to select the IPC files. 

- loads the selected files. 

- creates an image editted with user-selected criteria and 
searches for discrete sources over a designated region of 
the sky. 

- examines selected x-ray point sources and creates output. 

- creates an input data file for aips. 

- exits the user from the Op-Ed system and returns him/her 
to the UNIX prompt %. 
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i^ttapter II. l 


HELP 


<Help> calls the main menu which lists all of the functions 
available in Op-Ed. Any time a prompt appears, the user may 
use <help> to obtain a list of the functions. The Op-Ed 
functions are Diskcheck, Exam, Exit, Help, Load, Remove, 
Select, Scan and Spacecheck. 


* Example 01* 

When the user initiates <help>, the screen should read: 


Op-Ed> help 


The valid commands are: 


araip 

diskcheck 

exam 

exit 

help 

load 

remove 

scan 

Select 

spacecheck 


create data files viewed by aips on IIS. 
check which optical disk is currently mounted, 
examine point sources found by <scan>. 
exit the Op-Ed system, 
list the valid commands. 

load IPC files selected by <select> from optical disk. 

remove all the XPR files in your directory. 

scan for point sources using IPC files loaded by <load> 

select a new set of IPC files. 

check for magnetic disk space usage. 


For more information, please refer to the Op-Ed Manual. 


Op Ed> Here, the user should enter the appropriate command. 
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SPACECHECK 


When running Op-Ed it is important to keep track of the 
available magnetic disk space provided by the computer system. 
Often/ a user will run into problems when he/ she runs short of 
space. When the user selects files, he/she is told the file 
sire of the selection. At this point, it is wise for the user 
to ponpare the file size with the amount of available magnetic 
disfc space to ensure that the computer can accomodate the Op-Ed 
programs . 

The user may <exit> Op-Ed to check the magnetic disk status 
by using the appropriate UNIX command, 'df'. However, Op-Ed 
provides the command <spacecheck> which conveniently permits 
the user to check the status of the magnetic disk space from 
inside of the Op-Ed system. 

<Spacecheck> provides the user with the following 
information: 

Filesystem - device file name 

Kbytes - total size of the IPC disk in units of 
kilobytes 

“ amount of disk space already occupied in 
units of kilobytes 

Avail - amount of available disk space in units 

of kilobytes 

Capacity — percentage of disk space already occupied 

Mounted on - refers to the IPC disk name 

In addition, <spacecheck> lists a breakdown of the occupied 
magnetic disk space by indicating the amount of kilobytes used 
by each user and the corresponding user names. If the user finds 
that he/she is short on disk space, either the Op-Ed command 
<remove> should be executed, or he/she should request that other 
users delete files to create space on the magnetic disk. 


*Example 02* 


Op-Ed> spacecheck 


Filesystem kbytes 

/ dev/da2g 411128 

29960 /ipc/Einstein 
1400 /ipc/aips 

18688 /ipc/ipc 

24 /ipc/isis 

7021 6 /ipc/sde 

104 . / ipc/wxy 


used avail capacity Mounted on 

121816 248192 33% /ip c 


Op-Kd> 
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DISKCHECK 


<Diskcheck> tells the user which optical disk is 
currently mounted on the drive. Furthermore , <diskcheck> 
indicates if the drive is in use or available. 

Due to hardware limitations, only one user may use 
the optical disk drive at a time. Before the user 
begins to <load>, it might be helpful to determine the 
status of the optical disks and the drive. 


* Ex ample 03* 

In the case below, optical disk ipc__#5 is on the drive and 
it is not in use. Hence, the user is free to use the drive, 

Op-Ed> diskcheck 

ipc_#5 is currently mounted and available. 

Op-Ed> 

In the following case, another user is loading files from ipc__#3. 
Op-Ed> diskcheck 

ipc_#3 is currently mounted and in use. 


Op-Ed> 


Chapter IX ,4 


SELECT 


All of the IPC data files are recorded on optical disks 1 
through 5. In order to access the data, the user must <select> 
the appropriate files from the catalogue. <Select> permits t e 
user to choose files according to major frame or HOT number, 
sequence number and/ or sky coordinates . When using more . an 
one selection criteria, <select> is inclusive. More specifically, 
if a user selects both a specific sky coordinate and a sequence 
number, all sources that have either value are selected. 

The user may choose either to input manually a list of one or 
more HUT numbers, the minimum and maximum values for a range of 
HOT numbers, and/or the name of a file which contains a is o 
HOT numbers . Please note that a file containing a list o _ 

HOT numbers should consist of a single column of values of which 
the last entry is a -1. In addition, this file must be m the 

directory /ipc/(user name). . 

Similarly, the user may choose either to input manually a list 
of one or more sequence numbers, the minimum and maximum values 
for a range of sequence numbers, and/or the name of a i e w ic 
contains a list of sequence numbers. The sequence list file 
format resembles that of the HUT numbers in that it should 
list the values in a single column and conclude with a 1 an 
must reside in the directory /ipc/ (user name) . 


* Example 04* 

The following is a file, seqlist, which could be used as 
input for selecting the 5 listed sequence numbers. 

filename: seqlist 

27 

30 

35 

10770 

10556 

-1 


To <select> files according to the sky coordinates, the user 
must supply the right ascension and declination of the center of 
the field and the radius of the desired area. The corresponding 
units required are hours minutes seconds, degrees minutes secon s 
and arcminutes. 

When manually entering a list of sky coordinates, the first va ue 
input should be the radius of the field that the user wants to scan. 

On the following line, the user should enter the coordinates o e 
first field center separating each value by a blank space. Similanly, 
the next line shou.ld contain the second coordinate and so on until a 


list. If^he^ser^ant^to ^ n69ative entry den °tes the end of the 
-ay enter the n^e f Center COOrdi ^te S , he/she 

file must resiHn L Z ^ °? ntains a list of the values. The 
as follows: directory /ipc/<user name) and be formatted 

line 1: radius of field 
line 2. first field center sky coordinate 
!; a « cond field center sky coordinate 
, , ’ third field center sky coordinate ... 

line: negative sky coordinate. 


♦Example 05* 


- =rs-*rs£ £ile 

P the sec ond example of a <select> run. 

File name: skycoordlist 


30 

I € 0 13 4 0 

4 13 26 100 

5 18 16 16 35 25 

8 0 0 10 0 32 

9 0 22 14 4 0 

II 19 35 -77 48 0 
14 20 0 73 0 0 

14 14 13 9 0 0 

18 21 17 -34 25 0 

19 19 0 15 0 0 
23 11 0 2 24 0 
-1 0 0 0 0 0 


Once the selection criteria have been set-'h,, <-k 
provides a summary of the select-^ t Y USer ' ° p-Ed 

good exposure tiZ fin second " ° f records ' amount of 
file size (in nl f econd s) , average count rate, and total 

the file size to the ^ N ° te that the USer shouid compare 
by <spacecheck> amoun t of available disk space provided 

fills! "Z list^appears Tt? ^ *** * liSt ° f the «*«*«* 

In addition the lisf • ° ^ termi nal one screen at a time. 

for reference. The use? m^re^ /lpc/ (user name) /ipclist 

of increasing HUT number, sequenc^um^^^ 11311 ° rder 

exposure time, total count rate or fii? • as cension, declination, 

the sequence number Slze ‘ For each file, 

exposure time, count rate ascenslon / declination, roll angle, 

location (tape number/file ^ ^ eCOnd ' slze (kilobytes) , and 

ape number/file number on tape/disk number) is given. 


Three examples are provided below. 
06, all of the files are selected that 


In the first case, example 
have a sequence number of 27 


It is then requested that the files be listed in order of increasing 
HUT number. In the second case, 07, a previously executed command is 
still running. And in the third case, 08, the user opts to input a s y 
coordinate list file. The properly formated input file "skycoordlxst 
is shown in example 05. Here, the user requests to see the selected 
IPC files in order of increasing sequence numbers. 


* Ex ample 06* 

Op-Ed> select 

Hake file selection on: (pick a number) 

(1) specific major HUT numbers 

(2) major HUT number range 

(3) major HUT number list file 

(4) specific sequence numbers 

(5) sequence number range 

(6) sequence number list file 

(7) specific sky coordinates 

(8) sky coordinate list file 

(9) select these files 

(0) quit 

4 

Enter each sequence number, end with -1: 
(from 27 to 10776) 

27 

-1 

Make file selection on: (pick a number) 

(1) specific major HUT number 

(2) major HUT number range 

(3) major HUT number list file 

(4) specific sequence numbers 

(5) sequence number range 

(6) sequence number list file 

(7) specific sky coordinates 

(8) sky coordinate list file 

(9) select these files 
(0) quit 

9 

number of records selected = 19 

good exposure time (second) = 47528-32 

average count rate (c/s) = 1.285044 

and total file size (kb) = 17555 


Do you want to see the files 
(answer with "yes" or "no") 


selected? 


yes 


Select one order to sort the records: 

(1) major HUT number 

(2) sequence number 

. (3) Right Ascension 

(4) Declination 

(5) exposure time 

(6) total count rate 

(7) file size 

(0) sorry, do not list 


Filename Seq# 


R. A. 


Dec. 


Roll Time 


IPC0665177 

IPC0665231 

IPCO 665377 

IPC0665525 

IPC0666139 

IPC0666215 

IPC0666363 

IPC0667185 

IPC0667311 

IPC0667458 

IPC0668227 

IPC0668296 

IPC0668443 

IPC0669336 

IPC0669391 

IPC0669538 

IPC0670308 

IPC0670376 


27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9ra 59s 


27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 

27 

14h 

9m 59s 


72d 59m 59s 146 1311 

72d 59m 59s 146 3029 

7£d 59m 59s 146 2785 


72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59ra 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 
72d 59m 59s 


146 

325 

1 44 

1966 

144 

3587 

144 

3021 

144 

2770 

144 

2699 

144 

2580 

144 

2006 

144 

3384 

144 

2813 

145 

1597 

145 

2499 


145 2948 

145 2034 

145 3301 


Press return to continue, 
(pressed return) 


Answer "quit" to stop display 


Rate Size 
c/s kb 
1.3 408 

1.3 1243 

1-3 1271 

1-3 198 

1-3 340 

1-3 902 

1-3 927 

1-3 1114 

1-3 1348 

1-3 1319 

1-3 353 

1-3 963 

1-3 1009 

1-3 397 

1-3 1455 

1-3 1652 

1-3 331 

1-3 1125 


Location 
tt/fff/d 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 
43/ 55/3 


Filename Seq # R. A. Dec . p 

XPC0670523 27 14h 9m 59s 72d 59m 59s 

Another copy is sav ed in the file "ipclist". 


Time Rate 
sec c/s 
2872 1.3 


Size Location 
kb tt/fff/d 
1200 43/ 55/3 


Op-Ed> 



Once the user is confident in his/her selection 
should proceed to <load> the necessary files from t e op ica * 

Moreover, <select> has a built in safety feature which prevents th 
user from selecting new files if either <scan> or <exam> is running. 


♦Example 07* 

If the user tries to <select> new files before <scan> has completed, 
the following message will appear: 


Op-Ed> select 

The command scan is sill running* 
You cannot select new files now. 


Op-Ed> 


In this case, the user should wait a few minutes 
The user is free to select other commands that can 
with <scan>. 


until <scan> ends, 
run simultaneously 


♦Example 08* 


Op-Ed> select 

Make file selection on: (pick a number) 

(1) specific major HUT numbers 

(2) major HUT number range 

(3) major HUT number list file 

(4) specific sequence numbers 

(5) sequence number range 

(6) sequence number list file 

(7) specific sky coordinates 

(8) sky coordinate list file 

(9) select these files 

(0) quit 


Enter the name of RA and DEC list file: 
skycoordlist 

Make file selection on: (pick a number) 

(1) specific major HUT numbers 

(2) major HUT number range 

(3) major HUT number list file 

(4) specific sequence numbers 


9 


( 5 ) sequence number range 
<6) sequence number list file 

( 7 ) specific sky coordinates 

(8) sky coordinate list file 

( 9 ) select these files 

(0) quit 


.number of records selected - 28 

good exposure time (second) « 35621.44 

average count rate (c/s) - 1.594658 

and total file size (kb) - 9514 

Do you want to see the files selected? 
yes 


Select one order to sort the records: 

(1) major HUT number 

(2) sequence number 

( 3 ) Right Ascension 

(4) Declination 

( 5 ) exposure time 

(6) count rate 

( 7 ) file size 


(0) sorry , do not list 

2 


Filename 


IPC1134504 

IPC0221163 

IPC0221182 

IPC1880035 

IPC1880197 

IPC0527263 

IPC0720834 

IPC0720894 

XPC0720940 

XPC0721088 

XPC0721174 

IPC0721236 

IPC0309940 

IPC0309966 

IPC0457169 

XPC0457214 

IPC0457288 

IPC0957009 


Seq# 


323 

489 

489 

1000 

1000 

1122 

1197 

1197 

1197 

1197 

1197 

1197 

2233 

2233 

3234 

3234 

3234 

4521 


R.A. 


Dec. Roll 




5 h 

5 h 

19h 

19h 

llh 

19h 

19h 

19h 

19h 

19h 

19h 

18h 

18h 


18m 16s 
18m 16s 
18m 47s 
18m 47s 
19m 35s 
20m 50s 
20m 50s 
20m 50s 
20m 50s 
20m 50s 
20m 50s 
21m 17s - 
21m 17s - 


16d 

16d 

14d 

14d 

-77d 

14d 

14d 

14d 

14d 

14d 

14d 

■34d 

•34d 


35m 25s 
35m 25s 
59m 59s 
59m 59s 
47m 59s 
57m 23s 
57m 23s 
57m 23s 
57m 23s 
57m 23s 
57m 23s 
24m 59s 
24m 59s 


75 

90 

90 

-108 

-108 

47 

101 

101 

101 

101 

101 

101 

-90 

-90 


23h 10m 50 s 2d 24m 9s -66 

23h 10m 50s 2d 24m 9s -66 

23h 10m 50s 2d 24m 9s -66 

4h 13m 26s 0d 55m 47s 104 


Time Rate Size Location 
sec c/s kb tt/fff/d 
1276 1.6 209 5/ 22/1 

562 1.6 89 31/ 11/3 

2048 1.6 287 31/ 11/3 

2636 1.6 910 29/ 11/3 

1596 1.6 256 29/ 11/3 

1084 1.6 415 35/ 89/3 

1720 1.6 351 23/ 63/2 

0 0.0 7 23/ 63/2 

2335 1.6 617 23/ 63/2 

2130 1.6 578 23/ 63/2 

0 0.0 128 23/ 63/2 

1005 1.6 258 23/ 63/2 

745 1.6 182 32/ 76/3 
2130 1.6 503 32/ 76/3 

679 1.6 305 35/ 13/3 

272 1-6 219 35/ 13/3 

1857 1.6 1523 35/ 13/3 

1204 1.6 218 53/ 57/4 


Press return to continue. Answer "quit" to stop display. 


(return) 


Filename 

Seq# 

R< 

.A. 


Dec. 

IPC1696946 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697078 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697088 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697214 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697352 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697489 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697626 

10437 

14h 

14m 

13s 

9d 

6m 

IPC1697635 

10437 

14h 

14m 

13s 

9d 

6m 

IPC0489547 

10766 

lh 

6m 

5s 

13d 

3m 

IPC0489681 

10766 

lh 

6m 

5s 

13d 

3m 


Another copy is saved in file "ipclist". 


Roll 

Time 

Rate 

Size 

Location 


sec 

c/s 

kb 

tt/fff/d 

38s -108 

1142 

1.6 

305 

49/ 

27/4 

38s -108 

287 

1.6 

46 

49/ 

27/4 

38s -108 

1124 

1.6 

262 

49/ 

27/4 

38s -108 

1814 

1.6 

298 

49/ 

27/4 

38s -108 

1817 

1.6 

278 

49/ 

27/4 

38s -108 

1672 

1.6 

480 

49/ 

27/4 

38s -108 

246 

1.6 

37 

49/ 27/4 

38s -108 

1563 

1.6 

223 

49/ 

27/4 

59s -68 

1479 

1.6 

243 

57/ 

10/4 

59s -68 

1199 

1.6 

287 

57/ 

10/4 


Op-Ed> 


Chapter II. 5 
LOAD 


in order to <load> the files from the optical disks, the user 
must first <select> the files that he/she wants. Once the 
file? have been properly selected, <load> can be initiated from 

the Op-Ed> prompt. „ , . 

It is likely that the selected files are recorded on more than 

one optical disk. <Load> first reads the files from the dis 
that is currently on the drive. Then, <load> will promp 
user to place the appropriate disk on the drive. In order to 
read all of the necessary files, the user may have to mount 
several disks. To change the optical disks properly, it is 
useful to understand the configuration of the disk drive. 

All of the Einstein Data is contained on 5 sides 
of optical disks numbered IPCjfl, IPC_#2, . . .,IPC_#5. Each 
cartridge holds one disk with two sides, A and B. The 
cartridges are labeled to indicate which side corresponds to 

each IPC #. , 

The drive used at CAL is located on the 13th floor beside 

the CONVEX. The drive has two slots labeled A and B. T e 
optical disk resides in slot A as, the cartridge is stored 
in slot B. The disk must be removed directly from the cartridge 
into the drive slot A. Similarly, the disk must be replaced 
directly from the drive slot A into the cartridge. 

Begin this procedure by switching the drive to the off 
position. The round green light will blink for approximately five 
seconds. Once the green light is permanently off, remove the 
empty cartridge from slot B. Then, keeping the same side of the 
cartridge face up, cautiously place the cartridge in slot A. Be 
sure to push the cartridge as far back as it will go, 
remove it. Please note that it is important not to flip the 
empty cartridge to ensure that the disk will be replace rig 

side up. . 

Now, you are ready to insert the appropriate disk in the drive. 

Holding the cartridge with the disk IPC_# indicated below face-up, 
insert it into position in slot A, then remove it. If this was done 
correctly, the cartridge should feel lighter since it no longer 
contains the disk. The disk is now in slot A. Keeping the same 
side up, you must continue by inserting the empty cartridge into 
slot B for storage while you load from the disk. 

Finally, switch to start and wait for a constant green light. 

Instructions similar to those above are provided by Op Ed 
the first time that a disk must be changed. It may not be 
necessary to change disks if the desired files are contained 
on the disk which is currently mounted on the drive. The user 
can determine the status and the number of the optical d 
which is currently on the drive by using <diskcheck>. 


* Example 09* 


In this case, the user selects to load files that are 

^ ° n 3n ° ptical disk that previously been mounted 
on the drive : 


Op-Ed> load 

Loading XPR files from optical disk ipc_#3, please wait 
(a few minutes pass until loading finishes) 

Op-Ed> 


Due to hardware limitations, only one user may use <load> 

informo^K. ff the USer st ° ps the 3° b <load>, Op-Ed must be manually 

0therwise ' if the user later attempts 
in ,i«a ° ad>/ be/she will be messsaged 'Optical Drive already 

there is nfoS^ ***** 1 * ” the User is absolutely confident that 

followino US€r ' then the Situa tion can be rectified by the 

ronowing set of procedures. 

proi^>t P_Ed by entering the con ™and <exit> after the Op-Ed> 

-At the % prompt, enter the command: 

echo no > /mnt2 /Einstein/oped message/reading 
-Return to Op-Ed. — ' 

-Proceed. 


by usinc^the <±LskS Ca " ** raounted from the UNIX mode 

9 appropriate commands, it is important that the 

user mount each optical disk after it is placed on the drivj and 

be£ ? re “ “ remOVed flom the (Ple«M 

Pl ‘° " ™ IX "f"" 1 - ” OHIX commands' for more details) 

OD-Ed o ,. G ' the dlsk drive should never be left empty. The 

dLS “T <l0ad> ^maticnlly mounts and unmountTtL 

d“£s in tha P d°" PtS tke “ Ser - The “ er should ®“ly place the 
1 * a EOn,OVe the " as instructed by Op-Ed 

-V proceed ha/aha 


Chapter II. 6 
REMOVE 


If a user finds that he/she is low on magnetic disk space, 
Op-Ed offers the command <remove> which removes all or some ot 
the XPR files from the directory /ipc/(user name). 

<Remove> permits the user to delete unwanted XPR files. The 
user must specify whether he/she prefers to include or exclu 
the most recently selected files in permanently deleting 
previously selected XPR files. In addition, the user has 
the option to exit <remove> without deleting any files and 
to return to promt Op-Ed>. 


* Example 10* 

In the following case, the user is certain that he/she wants 
to erase all previously selected XPR files . 

Op-Ed> remove 

Do you want to delete: 

all - all of hte XPR files , . . 

part - all of the XPR files excluding those most recently se e 

none — qquit and return to Op— Ed> 

Please type "all", "part" or "none" to respond, 
all 

(a moment passes until the operation is completed) 


Op-Ed> 


Chapter II. 7 


SCAN 


To create an image from the XPR file and locate discrete X-ray 
sources therein one uses the command scan. Once the user has 
loaded the appropriate files, he/she may initiate <scan>. <Scan> 
searches for sources over a region of the sky using the selected 
Einstein IPC files (TGR and XPR) which cover the designated area. 

A unique advantage of Op-Ed is that the user has complete 
control over editting the raw data to produce images optimized 
for the scientific problem at hand. A large amount of data is 
then available for the first time, and images with very low amounts 
of contaminating counts can be created. 

The user may customize the XPR photon selection criteria by choosing 
one or several of the following options: 

- ' change masked out data' automatically switches the status 

from "include" to "do not include" masked out data or vice 
versa . 

- 'change rib width' prompts the user to input the optimal 

rib width . 

- ' change PHA PI bin' alternates the status of the bin selection 

between PHA and PI. 

- ' change energy range' permits the user to input the minimum and 

maximum energy bin. 

- 'default settings' submits no masked out data, deletion of 

4 arcmin under ribs, use of PI bin energy and an energy range 
channel 2 to 10. 

- 'accept it' sets the criteria as listed on the screen and 

continues to customize the TGR criteria. 

The user may accept or change the TGR selection criteria. 

The changes have been divided into two categories, basic and 
special. 

One or several of the following basic specifications can 
be made: 

- 'background level' ranges from 0 to 4. 

- 'viewing geometry' ranges from 1 to 5. 

- 'high voltage value' ranges from 0 to 9. 

- 'aspect separation' ranges from 0 to 15. 

- 'aspect mode' provides the option to include no aspect, 

locked on mode, extrapolated mode and/or map mode 
data . 

One or several of the following special specifications can 
be made : 

- 'telemetry' may include the good or bad telemetry, or 
both. 

~ 'high voltage' on, off or both may be included. 

- 'data' that is good, bad or both may be included. 

filter in place, not in place or both may be included. 

' calibration' , no calibration, or both may be included. 

I-oi definitions and explanations of Einstein terminology 


(ie, calibration, high voltage, etc.) please refer to the 
"Einstein Observatory Revised User's Manual" edited by 
D.E. Harris. 

The user may opt to select the default settings of: 

- background level 0-2 

- viewing geometry 1-3 

- high voltage 4-9 

- aspect separation 0-15 

- aspect mode locked on mapping 

~ good telemetry only 

' - high voltage on only 

- good data only 

- no filter in place 

- no calibration data 

Once the criteria have been selected and accepted, the user 
must enter the right ascension and declination of the scan area 
and the desired signal-to-noise ratio threshold for the discrete 
source search. 

Each time that the skycoordinates are entered, Op-Ed saves them 
in a sile so that during the following run of scan, the user can 
opt to reuse the prior list of pointing vectors. Also, if the user 
enters a negative value as the first entry of the pointing vectors, 
<scan> automatically inputs the sjpy coordinates of the first field 
listed in xpclist. <Scan> then produces the files digi t_map and 
source_list which are explained in Section III of the manual. 

It should be noted that each time <scan> is run, new files are 
produced that replace the previously created files. The user 
is presented with the option either to overwrite or to rename 
any existing such files. 

Also note that analysis of the maps created here using the option 
<exam> can be done using the same editting criteria or any subset 
and/or superset thereof. 


♦Example 11* 

In the case below, the user is running scan for the second time. 
The user chooses to save the old output files by opting to rename 
them. Furthermore, he/she makes many changes to the TGR and 
XPR photon criteria. Please note that the user chooses only 
one area to scan. 


Op-Ed> scan 

The file digit_map exists which will be overwritten by your new task.- 
Do you want to keep the previous file? 

yes 

Please give it a new name: 


olddigit 


new tssk 


The file source_list exists which will be overwritten by your 
Do you want to keep the previous file? 


yes 


Please give it a new name: 


oldsodrces 


The current XPR photon criteria are 


no masked out data 

delete 4 arcmin data under ribs 

use PI bin energy 

energy range: channel 2 to 10 

Your option to: 

(0) accept it 

(1) change masked out data setting 

(2) change ribs width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The current XPR photon criteria are: 

include masked out data 
delete 4 arcmin data under ribs 
use PI bin energy 
energy range: channel 2 to 10 

Your option to: 

(0) accept it 

(1) change masked out data setting 

(2) change ribs width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


Enter the width of the ribs: 
(in arc minute unit) 


The current XPR photon criteria are: 


include masked out data 


delete 3 arcmin data under ribs 

use PI bin energy 

energy range: channel 2 to 10 

Your option to: 


(0) accept it 

(1) change masked out data setting 

(2) change ribs width setting 
. (3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The current XPR photon criteria are: 

include masked out data 
delete 3 arcmin data under ribs 
use PHA bin energy 
energy range: channel 2 to 10 


Your option to: 

(0) accept it 

(1) change masked out data setting 

(2) change ribs width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


4 

Enter the lowest energy channel: 
(from 0 to 15) 

1 


Enter the highest energy channel: 
(from 0 to 15) 


The current XPR photon criteria are: 

include masked out data 
delete 3 arcmin data under ribs 
use PHA bin energy 
energy range: channel 1 to 9 

Your option to: 

(0) accept it 

(1) change masked out data setting 


(2) change ribs width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The qurrent TGR criteria are: 


background level : 0 

viewing geometry: 
high voltage value: 
aspect separation: 0 

aspect mode : 
good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 


1 2 
12 3 

4 5 6 7 

1 2 3 4 5 6 7 

locked on 


8 9 

8 9 10 11 12 13 14 15 

mapping 


Your option to: 

(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 


1 


Make change on: 

(0) exit 

(1) background level 

(2) viewing geometry 

(3) high voltage value 

(4) aspect separation 

(5) aspect mode 


Enter the lowest background level: 
(from 0 to 4) 

0 

Enter the highest background level: 
(from 0 to 4) 


4 


Make change on: 


(0) exit 



4 


(1) background level* " 

(2) viewing geometry 
<3) high voltage value 

(4) aspect separation 

(5) aspect mode 


Enter the lowest aspect separation: 
(from 0 to 15) 

0 

Enter the highest aspect separation: 
(from 0 to 15) 

10 


Make change on: 

(0) exit 

(1) background level 

(2) viewing geometry 

(3) high voltage value 

(4) aspect separation 

(5) aspect mode 


The current TGR criteria are: 


background level : 0 

viewing geometry: 
high voltage value: 
aspect separation: 0 

aspect mode: 
good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 


12 3 4 

12 3 

4 5 6 7 8 

12345678 
locked on 


9 

9 10 

mapping 


Your option to: 


(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 


Change setting on: 


(0) exit 


(1) telemetry 

(2) high voltage 

(3) bad data 

(4) filter 

(5) calibration 


The current TGR criteria are: 


background level: 
viewing geometry: 
high voltage value: 
aspect separation: 
aspect mode: 
good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 


0 12 3 4 

12 3 

4 5 6 7 8 

012345678 

no aspect 


9 

9 10 


Your option to: 

(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 


0 

A file of pointing vectors already exists. 
Do you want to use it? 


no 

Enter the center RA and DEC of the scan area: 

(hour min sec deg min sec) 

14 9 59 72 59 59 

Enter the source signal to noise ratio criterion. 

4 

Another pointing? Enter again: 

(negative hour to exit) 

-14 00000 

The job scan is submitted. 

Two files will be created: digit_map and source_lrst 


Op-Ed> 


Chapter II. 8 


EXAM 


<Exam> examines the X-*ray point sources listed in the 
<scan> output file source__list- The results of <exam> 
are written in the files named print__out and spec__out* 

For each source/ <exam> produces the raw maps of 
photon count/ exposure time/ and flux* In addition/ <exam> 
calculates an accurate position for each source and displays 
its spectrum and hardness ratio. 

The procedures for running <exam> are very similar to 

those for <scan>. 

The user may customize the XPR photon criteria by choosing one 
or several of the following options : 

- 'change masked out data' automatically switches the status 

from "include" to "do not include" masked out data or vice 
versa. 

- 'change rib width' prompts the user to input the optimal 

rib width. 4 

- 'change PHA PI bin' alternates the status of the bin selection 

between PHA and PI. 

- 'change energy range' permits the user to input the minimum an 

maximum energy bins. 

- 'default settings' submits no masked out data/ deletion of 

4 arcmin tinder ribs, use of PI bin energy and an energy range 
channel 2 to 10- 

- 'accept it' sets the criteria as listed on the screen and 

continues to customize the TGR criteria. 

The user may accept or change the TGR selection criteria. 

The changes have been divided into two categories/ basic and 
special . 

One or several of the following basic specifications can 
be made: 

- 'background level' ranges from 0 to 4. 

- 'viewing geometry' ranges from 1 to 5. 

- 'high voltage value' ranges from 0 to 9. 

- ' aspect separation' ranges from 0 to 15. 

- 'aspect mode' provides the option to include no aspect/ 
locked on mode, extrapolated mode and/or map mode 
data. 

One or several of the following special specifications can 
be made: 

- ' telemetry' may include the good or bad telemetry/ or 
both . 

- 'high voltage' on, off or both may be included. 

- 'data' that is good, bad or both may be included. 

- 'filter' in place, not in place or both may be included. 

- 'calibration' , no calibration, or both may be included. 

The user may opt to select the default settings of: 

- background level 0-2 

- viewing geometry 1-3 


~ voltage 4-9 

aspect separation 0-15 

- aspect mode locked on mapping 
good telemetry only 

high voltage on only 

- good data only 

- no filter in place 
~ no calibration data 


* Example 12* 


In this case, the user first 
<scan> has f inshed running. 


attenpts to run <exam> before 


Op-Ed> exam 


The source_list file is empty. 

Please use scan command to detect point 


sources before running exam. 


again! < ^ > finish * 3 ' th «n tries <exam> 
as the example 11 of this mo" i W?S 11111 USing the saroe criteria 
user opts to set the S Ual ' ^° wever ' to »n <exam> the 

- — rs: 


*Example 13 * 


Op~Ed> exam 

Co you want to'keep th^preSoL^iL^ ° Verwritten new task, 

yes 


Please give it 


a new name: 


oldfile 


The current XPR photon criteria are 

include masked out data 
delete 3 arcmin data under ribs 
use PHA bin energy! 

energy range; channel 1 to 9 
Your option to: 

(0) accept it 


(1) change masked out data setting 

(2) change rib width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The current XPR photon criteria are: 

4 

no masked out data 

delete 4 arcmin data under ribs 

use PI bin energy 

energy range: channel 2 to 10 


Your option to: 


<0) accept it 

(1) change masked out data setting 
<2) change rib width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The current TGR criteria are: 


background level : 01234 

viewing geometry: 123 

high voltage value: ^ 

aspect separation: 01234 

aspect mode: no aspect 

good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 


5 

5 


6 7 
6 7 


8 9 

8 9 10 


Your option to: 


(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 


3 


The current TGR criteria are: 


background level: 0 

viewing geometry: 
high voltage value: 
aspect separation : 


1 

1 


2 

2 3 


4 5 6 7 

4 5 6 7 


8 9 

8 9 10 11 12 13 14 15 


0 


1 


2 


locked on 


aspect mode: 
good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 

Your option to: 

(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 


mapping 


The job exam is submitted. 

It will create the output file. 

Op-Ed> 


submit*^ Cr * teria have 1x5611 selected and accepted, ' Op-Ed 
<exam> as a background job allowing the user 
to Perform other tasks in the foreground as it runs. 

outom- • noted that each time <exam> is run, a new 

In lht t S Pr0dUCed that re P lace s the one previously created 

5 L: a ^7ir boTC - the u=et «*- *• -- t h e <7 


Chapter II . 9 
ARAIP 

<Araip> is an option availble for users who wish to use their 
output on Aips . It is especially convenient for those users 
interested in viewing the flux array of their sources on the 
International Imaging System (IIS) screen. 

Once the user has selected the appropriate sources, he/she is 
ready to run <iaraip>. In order to run <araip>, the user must 
enter the sky coordinates of their field centers, preferred 
map size (the maximum is 1024 X 1024), and the number of IPC 
pixels. Please note that each IPC pixel is equivalent to 4 
ordinary pixels. 

Also, the user may select the criteria for which he/she 
wishes to scan the data. It is a similar menu driven 
selection process to those of scan and exam. 

The output file araip_data is created in the directory 
/ipc/ (user name) . The output file, araip__data, should be 
used only as input for Aips. It is not in legible format 
for UNIX. In order to access it in Aips, remeber to issue 
the following Aips command: 

> setenv NAME /ipc/ (user name) /araip_data 

such that "NAME" is any word in capital letters that is used 
as "input araip" in Aips. 


*Example 14* 


Op-Ed> araip 

The current XPR photon criteria are; 

no masked out data 

delete 4 arcmin data under ribs 

use PI bin energy 

energy range: channel 2 to 10 

Your option to: 

(0) accept it 

(1) change masked out data setting 

(2) change rib width setting 

(3) change PHA PI bin setting 

(4) change energy range 

(5) get default settings 


The current TGR criteria are: 


background level : 0 1 2 


viewing geometry :- 
high voltage value: 
aspect separation: 
aspect mode: 
good telemetry only 
high voltage on only 
good data only 
no filter in place 
no calibration data 

your option to: 


12 3 

4 5 6 7 

0123456 7 
locked on 


8 9 

8 9 10 11 12 13 14 15 

mapping 


(0) accept it 

(1) make basic changes 

(2) make special changes 

(3) get default settings 

0 

Enter the center RA and DEC of the map 
( our min sec degree min sec) 

-100000 


Enter the resolution of the square map: 
(number of pixels in both sides, f=1024) 

120 


Enter the pixel size: 

(number of i PC pixels of 8 arc seconds) 

4 


The job araip i s submitted. 

It will create a file called araip_data for aips 


Op-Ed> 


Chapter II. 10 


Exit 


When executed from the prompt Op-Ed>, <exit> returns the user 
to the UNIX Operating System prompt %. 


Chapter III.l 
<SELECT> OUTPUT 


<Select> produces two files, xprlist and tgrlist, in t e 
user's local directory, ipc/(user name), which 
serve as input for <scan> and <exam>. In addition, 
<select> creates hidden files .diskl, .disk2, ...,.diskh, 
in the user's local directory, which serve as input for 

The hidden files .diskl, .disk2, disks contain the 

selected IPC file names corresponding to the appropriate 
number disk on which it is recorded. <Load> inputs one 
.disk# file at a time as it loads the IPC files listed 
from the disk* 

* Example 15* 

in the case of <select> example given earlier in the 
manual, all of the IPC files are listed on disk #3. 
Therefore, the files .diskl, .disk2, .disk4 and .disks 
are emp ty. Only .disk3 contains IPC file names. 

Below is an example of -disk3. 


0665177 

0665231 

0665377 

0665525 

0666139 

0666215 

0666363 

0667185 

0667311 

0667458 

0668227 

0668296 

0668443 

0669336 

0669391 

0669538 

0670308 

0670376 

0670523 


The output file xprlist contains the names of the xpr files 
paired with the corresponding path names. The loaded 
xpr files are located in /ipc/ (user name) /xpr_f lie . 

The output file tgrlist contains the names of the tgr files 
paired with the corresponding path names. The tgr files 


are recorded off the magnetic disk. The loaded tgr files are 
located in /xnnt2/Einstein/tgr_file. 

The structure of Op-Ed enables the user to exit so that 
e/she may manipulate the output files from UNIX, To protect 
the fries from being overwritten, xprlist and tgrlist may 
be renamed through ordinary UNIX commands. As long as the 
mal format of tgrlist and/or xprlist is correct, the user may 
manipulate these files as he/she wishes. Please note that 
t e proper format is vital since the programs serve as input 
to <load>. The required formats are: 

5° r tgrlist: /mnt2/Einstein/tgr_file/ (file name) such that 

. the file name is written exactly as ipc(7 digit HUT number) .tgr 

* Example 16* 

/ mnt 2 /Einstein/tgr_f ile/ipcO 665177 . tgr 
/mnt2/Einstein/tgr_f ile/ipc0665231 . tgr 

/mnt2/Einstein/tgr_f ile/ipc0665377 . tgr 
/mnt2/Einstein/tgr_file/ipc0665525 . tgr 
/mnt2/Einstein/tgr_file/ipc0666139 . tgr 

/mnt2 /Einstein/ tgr_f ile/ ipc 0 66 62 1 5 . tgr 
/mnt2/Einstein/tgr_f ile/ipcO 666363 . tgr 
/mnt2/Einstein/tgr_file/ipc0667185.tgr 
/mnt2/Einstein/tgr__f ile/ipcO 667311 . tgr 

/mnt2/Einstein/tgr_file/ipc0667458.tgr 
/mnt2/Einstein/tgr_file/ipc0668227 . tgr 

/rant2 /Einstein/ tgr_f ile/ipcO 6682 9 6 . tgr 
/mnt2/Einstein/ tgr_f ile/ipc 0 668 4 4 3 . tgr 

/mnt2/Einstein/tgr_f ile/ipcO 669336. tgr 

/mnt2/Einstein/tgr_f ile/ipc0669391 . tgr 

/mnt2/Einstein/tgr_file/ipc0669538 . tgr 

/mnt2/Einstein/ tgr_f ile/ipcO 670308 . tgr 

/mnt2/Einstein/tgr_f ile/ipc0670376 . tgr 
/mnt2/Einstein/tgr_f ile/ipcO 670523. tgr 

f° r x Prlist: /ipc/user/xpr_file/ (file name) such that 

tfte file name is written exactly as xpr<7 digit HUT number) .xpr 

*Example 17* 

x P r _f ilc/ ipc0665177 . xpr 
x P r __ file/ ipcO 665231 , xpr 

X P*- file/ ipcO 665377 „ xpr 

x P r __f ile/ ipcO 66552 5 . xpr 

x P r file/ ipcO 6661 39 . xpr 

x P r __f ile/ ipc066621 5 . xpr 

x P r file/ ipcO 666363 . xpr 

x P r _f ile/ipcO 6671 8 5. xpr 
x P r _ f ile/ ipcO 667311 . xpr 
x P r _file/ipc0667458.xpr 

x P r file/ ipc0668227 . xpr 

x P r _f ile/ipcO 66829 6. xpr 
xpr_fil e /ipc0668443 . xpr 
x P r _ f ile/ipcO 66933 6. xpr 


xpr_f ile/ipcO 669391". xpr 
xpr_file/ipc0669538.xpr 
xpr_f ile/ipcO 67030 8 . xpr 
xpr_f ile/ipcO 670376 . xpr 
xpr_file/ipc0670523 .xpr 


Furthermore/ to maintain consistency, the user should remember to 
change all of the <select> output files when manipulating the files 
from the UNIX system; i.e., if the user edits tgrlist, he/she must 
make the corresponding changes in xprlist. 


DIGIT HAP 


Digit_map is a product of <scan>. It is a large file that 
provides the user with all of the information determined by 
<scan>. 

The output file digits map lists the right ascension and 
declination of three mappings/ followed by the three mappings 
themselves* The maps that appear are arrays of the photon 
counts, exposure times and fluxes (photons per exposure time 
for each pixel) of the field* 

Following the three maps, digit_map lists each detected 
source with its right ascension, declination, s ignal - to-noi se 
ratio (sigma), flux and flux upper limit* This final section 
of the digitaap contains the same data as eource_list* 

Please note that the structure of Op-Ed enables the user 
to exit to UNIX where he/she can manipulate, print or read 
digit__map* 


* Example 18 * 

Below is an example of digit__map. in this case, scan was run with 
the same criteria as shown in the <scan> example of this manual. 
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Chapter III. 3 


SOURCE_LIST 

i 


Source_ list a sma H file produced by <scan>. The 

ouput file source_list primarily functions as an input 
file for <exam>. 

'Source_ list lists the sources found by <scan> with the 
corresponding values of right ascension, declination, sigma 
(signal-to-noise ratio) , flux and the upper limit of the 
flux, respectively. However, the values are not labeled in 

source — * ft is a sublist of the larger, more easily 
read output file digit_map. 

The user should note that an identical file named 
source_ punch is simultaneously produced by <scan>. When 
a user edits source_list for the UNIX mode, he/she need 
not change sourcejpunch. However, if the user renames 
a source_punch file, the corresponding source_ punch file 
should also be renamed and saved. For users unfamiliar 
with the programs initiated by <scan>, please note that 
souce_ punch is a file that contains the list of souces 
that are to be punched out when scanning the field to 
produce images. <Exam> requires that the corresponding 
source_punch and source_ list be input. 


♦Example 19* 


The file source_list below was created according to the 
criteria set in the <scan> example given earlier in this 
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0.09059 0.11359 
0.06663 0.08718 
0.09654 0.12759 
0.09236 0.12286 


Chapter III. 4 


PRINT OUT 


The output file print_out contains all of the data 
produced by <exam>. Printout is a large, easy-to-read 
file. 

Print_out lists the original source positions followed by 
three maps of the corresponding photon count, exposure time 
and flux (photon count per exposure time for each pixel) . 

These maps differ from those in digitjnap in that they 
cover a much smaller area and in that they have twice the 
resolution. 

For each image file that covers a source corresponding to 
a selected file name, printout lists small maps of photon 
count and exposure time accompanied by the amount of exposure 
time at the center. 

For each channel (0-15), print__out provides the spectrum of 
photon counts at both the source position within a 3' radius 
and in surrounding annulus (5-8 arcmins) . This data may be 
used as input for Finspec . i 


* Example 20* 


The print_out file below was produced by using the default 
values for <exam> and <scan> for the selected files with 
a sequence number equal to 27. 
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SPEC CUT 


Spec_out is a file produced by <exam>. It is a subfile of 
containing only the spectrum data which may be 
used as input for Finspec. The format of spec_out is 
designed specifically to match the input requirements of 
Finspec. 

The first column of spec__out lists the background subtracted 
source counts for each channel from 1 to 15. The second column 
lists the errors. For more details, refer to the Standard SAO 
Information File for Finspec called FINSPEC. WU which resides in 
CUAPH1: :CAP: [USER. HEAO. SOURCE] FINSPEC. WU. 


*£xample 21* 

The file below was created simultaneously with the previous 
example of digit map. 


flua pec Input for looroe 
COUNTS, errors 


OFF.AXIS.ARCMIN 
LIVE. TIME 4S6' _ _ 
KXTRCE . RADIUS .ARCHIN 
'inspec input 
XXJNTS. ERRORS 


or source 

*t 14 

30.04 

11.29 * 

-20.35 

12.62 * 

-4.75 

9.77 * 

-16.41 

7.81 - 

1.53 

7.42 * 

-6.60 

6.39 * 

4.09 

6. SO * 

-3.33 

4.94 ^ 

0.69 

6.16 ^ 

13.70 

7.46 * 

6.95 

8.13 * 

7.01 

9,49 - 

14.69 

11. S5 * 

0.37 

12,18 ~ 

-51.32 

14.86 

30.29 2 
1.3 

TUN 3.000 

■ source et 14 16 

-S.75 

3.52 * 

3.03 

8.77 A 

21.27 

9.03 * 

7.98 

6.99 ^ 

19.97 

7.10 A 

2.65 

4.79 ^ 

10.41 

<x> 

o 

> 

9.65 

5.09 ~ 

4.89 

4.71 - 

4.81 

4.42 * 

-0.07 

4.30 * 

-10.07 

4.37 * 

-0.58 

7.37 ~ 

19.31 

9.00 ~ 

85.77 

16.93 


7 3.9$ 73 27 54.40 


36.47 73 16 56.48 


'F. AXIS. ARCMIN 32.746 
VE.TIME 45673.3 
)URCE. RADIUS. ARCH IN 3.000 
napec input for sou 
UNTS . ERRORS 


source 

at 

14 

18 

-4 

.17 

2 

. 54 

- 

-3 

.06 

8 

.68 

" 

53 

.46 

10 

.79 

- 

31. 

.50 

8 

.92 

- 

32. 

.36 

8 

.73 

- 

29. 

.84 

7 

.53 

- 

13. 

.09 

5 

.67 

- 

20. 

.53 

6 

. 12 


31 . 

.09 

7 

.08 

- 

1 1 . 

48 

S 

.20 

- 

2. 

14 

6. 

.24 

- 

-7 . 

96 

6. 

36 

- 

2 . 

f 7 

8. 

26 

- 

-17. 

27 

9. 

31 

- 

14 . 

28 

17. 

68 
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26.73 9.21 - 

13.63 8.01 - 

10. 44 7.25 * 

1-37 €.97 - 

-7.97 6.78 - 

-4.97 8.23 ~ 

7.88 10.53 * 

-11.28 14.05 ^ 

1.21 15.75 * 

4.33 22.46 

OFF. AXIS .ARCHIN 11.805 
LIVE. TIME 45673.3 
SOURCE.RADI0S.ARCKIN 3.000 
finspec inpat for sou 
COUNTS . ERRORS 


>r source 

st 14 13 

18.31 

9.51 * 

35.43 

15,04 * 

31.26 

13.61 - 

26.48 

11,17 A 

21.71 

9.80 * 

29.46 

8.66 ~ 

15.14 

7.82 * 

15.38 

7.64 * 

10.86 

7.65 - 

10.22 

7.67 - 

19.58 

8.92 * 

16.20 

10.78 * 

20.31 

14.40 * 

36.12 

16.09 *■ 

-10.35 

21.66 

15.476 



28.00 73 0 40.79 


OFT. AXIS .ARCHXN 
LIVE. TIKE 45673.3 
SOURCE . RADIUS . ARCHIN 3.000 
finspec input for source et 
COUNTS. ERRORS 


14 


-12.65 11.46 * 

-21.90 15.24 * 

15.03 13.61 - 

35.54 12.28 * 

€-4S 9.67 - 

30.98 9.50 ~ 

17.09 8.59 * 

14 . 90 8.25 * 

-1.04 7.30 A 

10.68 8.31 * 
-18.25 7.73 * 

-39.86 9.78 * 

-45.51 13.03 * 

-3.41 16.54 ^ 

70.75 23,50 

JFF .AXIS .ARCMIN 4.062 
-rVE.TIME 45673.3 
SOURCE . RADIUS . ARCMIN 3.000 
inspec Input for source et 


5.32 72 58 7.28 


XXJNTS . ERRORS 


-25.13 

6.68 

0.12 


14 12 

8.37 * 
15.15 * 
12.96 - 


14.20 72 54 20.77 


F. AXIS. ARCMIN 
VE. TIME 4567 


JNTS • errors 


0.36 

10.73 * 

15.23 

9.93 ~ 

-8.68 

7.95 - 

-3.92 

7.28 - 

20.83 

8 . 54 - 

6.84 

7.34 A 

4.35 

7.81 * 

-9.60 

7.47 - 

-9.95 

9.82 - 

-6.44 

13.15 - 

€.47 

15.21 ~ 

-3S.06 

22.53 

11.709 

1.3 

»IN 3.000 

source at 14 5 

3.67 

9.02 - 

43.65 

14.86 - 

34.53 

12.42 ~ 

22.21 

9.89 - 

17.28 

8.48 ~ 

17.26 

7.<1 - 

8.63 

7.23 - 

21 . 82 

7.22 ^ 

11-33 

7.08 ^ 

4.01 

6.96 - 

19.85 

8-20 ~ 

15.09 

10.26 - 

23.-«i 

13.41 - 

10.78 

13.99 - 

15.67 

19.96 


49.90 72 S2 5.78 
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7.88 10.S8 - 

16.99 9.62 ~ 

5.78 7.35 * 

1.11 6.37 - 

2.81 5.42 A 

-5.36 5.00 * 

3.56 4.95 * 

—4.00 4.60 * 

€.98 5.46 * 

17.62 6.76 * 

16.99 8.21 * 

22.46 10.34 * 

11.14 11.44 - 

, -2.83 14.95 

OET.AXjSlARO^N 18.916 
UVe!*XHE 45673.3 
SOURCE. RADIUS. ARCHIN 3.000 

finspec input for source st 14 7 19.61 72 35 

COUNTS. ERRORS 12.21 9.07 * 

39.11 15.19 A 

7.55 12.87 ^ 

€9.21 13.30 * 

57.76 11.12 * 

€4.32 11.23 * 

76.62 11.17 * 

48.43 10.09 * 

44.34 9,73 * 

35.06 9.35 * 

10.65 9.22 * 

22.99 10.48 A 

17.66 12.94 * 

-9.88 14.81 

-13.50 19.17 

OFF. AXIS. ARCHIN 27.454 
LIVE. TIME 45673.3 


SOURCE. RADIUS. ARCHIN 3.000 


38.36 


40.25 
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